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1 Introduction 

1.1 Overview 

The Arduino microcontroller is an easy to use yet powerful single board computer that has 
gained considerable traction in the hobby and professional market. The Arduino is open-source, 
which means hardware is reasonably priced and development software is free. This guide is for 
students in ME 2011, or students anywhere who are confronting the Arduino for the first time. 
For advanced Arduino users, prowl the web; there are lots of resources. 

The Arduino project was started in Italy to develop low cost hardware for interaction design. An 
overview is on the Wikipedia entry for Arduino. The Arduino home page is 
http://www.arduino.cc/ . 

The Arduino hardware comes in several flavors. In the United States, Sparkfun 
(www.sparkfun.com) is a good source for Arduino hardware. 

This guide covers the Arduino Uno board (Sparkfun DEV-09950, $29.95), a good choice for 
students and educators. With the Arduino board, you can write programs and create interface 
circuits to read switches and other sensors, and to control motors and lights with very little effort. 
Many of the pictures and drawings in this guide were taken from the documentation on the 
Arduino site, the place to turn if you need more information. The Arduino section on the ME 
2011 web site, https://sites.google.eom/a/umn.edu/me2011/ , covers more on interfacing the 
Arduino to the real world. 

This is what the Arduino board looks like. 
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The Duemilanove board features an Atmel ATmega328 microcontroller operating at 5 V with 2 
Kb of RAM, 32 Kb of flash memory for storing programs and 1 Kb of EEPROM for storing 
parameters. The clock speed is 16 MHz, which translates to about executing about 300,000 lines 
of C source code per second. The board has 14 digital I/O pins and 6 analog input pins. There is 
a USB connector for talking to the host computer and a DC power jack for connecting an 
external 6-20 V power source, for example a 9 V battery, when running a program while not 
connected to the host computer. Headers are provided for interfacing to the I/O pins using 22 g 
solid wire or header connectors. For additional information on the hardware, see 
http ://arduino. cc/en/Main/ArduinoB oardUno . 

The Arduino programming language is a simplified version of C/C++. If you know C, 
programming the Arduino will be familiar. If you do not know C, no need to worry as only a few 
commands are needed to perform useful functions. 

An important feature of the Arduino is that you can create a control program on the host PC, 
download it to the Arduino and it will run automatically. Remove the USB cable connection to 
the PC, and the program will still run from the top each time you push the reset button. Remove 
the battery and put the Arduino board in a closet for six months. When you reconnect the battery, 
the last program you stored will run. This means that you connect the board to the host PC to 
develop and debug your program, but once that is done, you no longer need the PC to run the 
program. 

1.2 What You Need for a Working System 

1. Arduino Duemilanove board 

2. USB programming cable (A to B) 

3. 9V battery or external power supply (for stand-alone operation) 

4. Solderless breadboard for external circuits, and 22 g solid wire for connections 

5. Host PC running the Arduino development environment. Versions exist for Windows, Mac 
and Linux 

1.3 Installing the Software 

Follow the instructions on the Getting Started section of the Arduino web site, 
http://arduino.cc/en/Guide/HomePage . Go all the way through the steps to where you see the pin 
13 LED blinking. This is the indication that you have all software and drivers successfully 
installed and can start exploring with your own programs. 

1.4 Connecting a Battery 

For stand-alone operation, the board is powered by a battery rather than through the USB 
connection to the computer. While the external power can be anywhere in the range of 6 to 24 V 
(for example, you could use a car battery), a standard 9 V battery is convenient. While you could 
jam the leads of a battery snap into the Vin and Gnd connections on the board, it is better to 
solder the battery snap leads to a DC power plug and connect to the power jack on the board. A 
suitable plug is part number 28760 from www.iameco.com . Here is what this looks like. 
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Warning: Watch the polarity as you connect your battery to the snap as reverse orientation 
could blow out your board. 


Disconnect your Arduino from the computer. Connect a 9 V battery to the Arduino power jack 
using the battery snap adapter. Confirm that the blinking program runs. This shows that you can 
power the Arduino from a battery and that the program you download runs without needing a 
connection to the host PC 

1.5 Moving On 

Connect your Arduino to the computer with the USB cable. You do not need the battery for now. 
The green PWR LED will light. If there was already a program burned into the Arduino, it will 
run. 


Warning: Do not put your board down on a conductive surface; you will short out the pins on 
the back! 


Start the Arduino development environment. In Arduino-speak, programs are called “sketches”, 
but here we will just call them programs. 

In the editing window that comes up, enter the following program, paying attention to where 
semi-colons appear at the end of command lines. 

void setup() 

{ 

Serial.begin(9600); 

Serial.println("Hello World"); 

} 

void loop () 

{ } 

Your window will look something like this 
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Click the Upload button 


Click the Serial Monitor button 
message and look something like this 


or Ctrl- U to compile the program and load on the 
H. If all has gone well, the monitor window 


Arduino board, 
will show your 



Congratulations; you have created and run your first Arduino program! 
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Push the Arduino reset button a few times and see what happens. 


Hint: I f you want to check code syntax without an Arduino board connected, click the Verify 
button □ or Ctrl-R. 

Hint: If you want to see how much memory your program takes up, Verify then look at the 
message at the bottom of the programming window. 


1.6 Troubleshooting 

If there is a syntax error in the program caused by a mistake in typing, an error message will 
appear in the bottom of the program window. Generally, staring at the error will reveal the 
problem. If you continue to have problems, try these ideas 

• Run the Arduino program again 

• Check that the USB cable is secure at both ends. 

• Reboot your PC because sometimes the serial port can lock up 

• If a “Serial port.. .already in use” error appears when uploading 

• Ask a friend for help 


1.7 Solderless Breadboards 

A solderless breadboard is an essential tool for rapidly prototyping electronic circuits. 
Components and wire push into breadboard holes. Rows and columns of holes are internally 
connected to make connections easy. Wires run from the breadboard to the I/O pins on the 
Arduino board. Make connections using short lengths of 22 g solid wire stripped of insulation 
about 0.25” at each end. Here is a photo of a breadboard showing which runs are connected 
internally. The pairs of horizontal runs at the top and bottom are useful for running power and 
ground. Convention is to make the red colored run +5 V and the blue colored run Gnd. The 
power runs are sometimes called “power busses”. 
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Horizontal runs connected 



Vertical runs 
connected 


Warning: Only use solid wire on the breadboard. Strands of stranded wire can break off and fill 
the holes permanently. 

Hint: Trim wires and component leads so that wires and components lie close to the board. 


To keep the Arduino board and breadboard together, you can secure both to a piece of fom-core, 
cardboard or wood using double-stick foam tape or other means. 

2 Flashing an LED 

Light emitting diodes (LED's) are handy for checking out what the Arduino can do.. For this 
task, you need an LED, a 330 ohm resistor, and some short 
pieces of 22 or 24 g wire. The figure to the right is a sketch 
of an LED and its symbol used in electronic schematics 

Using 22 g solid wire, connect the 5 V power pin on the 
Arduino to the bottom red power bus on the breadboard and 
the Gnd pin on the Arduino to the bottom blue power buss 
on the breadboard. Connect the notched or flat side of the LED (the notch or flat is on the rim 
that surrounds the LED base; look carefully because it can be hard to find) to the Gnd bus and 
the other side to a free hole in main area of the breadboard Place the resistor so that one end is in 
the same column as the LED and the other end is in a free column. From that column, connect a 
wire to digital pin 2 on the Arduino board. Your setup will look something like this 



I .HI !■ 
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To test whether the LED works, temporarily 
disconnect the wire from pin 2 on the Arduino 
board and touch to the 5 V power bus. The LED 
should light up. If not, try changing the orientation 
of the LED. Place the wire back in pin 2. 

On the LED, current runs from the anode (+) to the 
cathode (-) which is marked by the notch. The 
circuit you just wired up is represented in schematic 
form in the figure to the right. 

Create and run this Arduino program 

void setup() 

{ 

pinMode(2,OUTPUT); 

digitalWrite(2,HIGH); 
delay(1000); 
digitalWrite(2,LOW); 

} 

void loop() 

{ ) 

Did the LED light up for one second? Push the Arduino reset button to run the program again. 

Now try this program, which will flash the LED at 1.0 Hz. Everything after the // on a line is a 
comment, as is the text between 7 *’ and ‘*/’ at the top. It is always good to add comments to a 
program. 



/* - 

Blinking LED, 1.0 Hz on pin 2 
-*/ 
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// one-time actions 


void setup () 

{ 

pinMode(2 , OUTPUT); // define pin 2 as an output 

} 

void loop () 

{ 

digitalWrite(2 , HIGH) ; 
delay(500); 
digitalWrite(2 , LOW); 
delay(500); 

} 

The pinMode command sets the LED pin to be an output. The first digitalWrite command says to 
set pin 2 of the Arduino to HIGH, or +5 volts. This sends current from the pin, through the 
resistor, through the LED (which lights it) and to ground. The delay(500) command waits for 
500 msec. The second digitalWrite command sets pin 2 to LOW or 0 V stopping the current 
thereby turning the LED off. Code within the brackets defining the loop() function is repeated 
forever, which is why the LED blinks. 

This exercise shows how the Arduino can control the outside world. With proper interface 
circuitry the same code can turn on and off motors, relays, solenoids, electromagnets, pneumatic 
valves or any other on-off type device. 

3 Reading a switch 

The LED exercise shows how the Arduino can control 
the outside world. Many applications require reading the 
state of sensors, including switches. The figure to the 
right shows a picture of a pushbutton switch and its 
schematic symbol. Note that the symbol represents a 
switch whose contacts are normally open, but then are 
shorted when the button is pushed. If you have a switch, 
use the continuity (beeper) function of a digital multi¬ 
meter (DMM) to understand when the leads are open and 
when they are connected as the button is pushed. 

For this exercise, the Arduino will read the state of a normally-open push button switch and 
display the results on the PC using the serial.println() command. You will need a switch, a 10 
kohm resistor and some pieces of 22 g hookup wire. If you don't have a switch, substitute two 
wires and manually connect their free ends to simulate a switch closure. The figure below shows 
the schematic for the circuit on the left and a realization on the right. 



// 

loop 

forever 

// 

pin 2 

high (LED on) 

// 

wait 

500 ms 

// 

pin 2 

low (LED off) 

// 

wait 

500 ms 
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Create and run this Arduino program 

void setup() 

{ 

Serial.begin(9600); 

} 

void loop() 

{ 

Serial.printIn(digitalRead(3)) ; 
delay(250); 

} 

Open the Serial Monitor window. When the switch is open, you should see a train of l's on the 
screen. When closed, the l's change to 0's. On the hardware side, when the switch is open, no 
current flows through the resistor. When no current flows through a resistor, there is no voltage 
drop across the resistor, which means the voltage on each side is the same. In your circuit, when 
the switch is open, pin 3 is at 5 volts which the computer reads as a 1 state. When the switch is 
closed, pin 3 is directly connected to ground, which is at 0 volts. The computer reads this as a 0 
state. 

Now try this program which is an example of how you can have the computer sit and wait for a 
sensor to change state. 


void setup() 

{ 

Serial.begin(9600); 

} 

void loop() 

{ 

while (digitalRead(3) == HIGH) 

r 

Serial.println("Somebody closed the switch!")/ 
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while (digitalRead(3) == LOW) 


Serial.println("The switch is now open!"); 

} 

Watch the activity in the Serial Monitor window as you press and release the switch. 

4 Controlling a Small DC Motor 

The Arduino can control a small DC motor through a transistor switch. You will need a TIP 120 
transistor, a IK resistor a 9V battery with battery snap and a motor. 


o 



The TIP 120 pins look like this b c e and on a schematic the pins are like this 



Here is the schematic diagram for how to connect the motor 



12 V 


And here is a pictorial diagram for how to connect the components. The connections can be 
soldered or they can be made through a solderless breadboard. 
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Pin 2 can be any digital I/O pin on your Arduino. Connect the minus of the battery to the emitter 
of the transistor (E pin) and also connect the emitter of the transistor to Gnd on the Arduino 
board. 

To check if things are working, take a jumper wire and short the collector to the emitter pins of 
the transistor. The motor should turn on. Next, disconnect the IK resistor from pin 2 and jumper 
it to +5V. The motor should turn on. Put the resistor back into pin 2 and run the following test 
program: 


void setup() 

{ 

pinMode(2 , OUTPUT) ; 
digitalWrite(2,HIGH) ; 
delay(1000); 
digitalWrite(2 , LOW); 


void loop() 

{} 

The motor should turn on for 1 second. 
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5 Arduino Hardware 

The power of the Arduino is not its ability to crunch code, but rather its ability to interact with 
the outside world through its input-output (I/O) pins. The Arduino has 14 digital I/O pins labeled 
0 to 13 that can be used to turn motors and lights on and off and read the state of switches. 

Each digital pin can sink or source about 40 mA of current. This is more than adequate for 
interfacing to most devices, but does mean that interface circuits are needed to control devices 
other than simple LED's. In other words, you cannot run a motor directly using the current 
available from an Arduino pin, but rather must have the pin drive an interface circuit that in turn 
drives the motor. A later section of this document shows how to interface to a small motor. 

To interact with the outside world, the program sets digital pins to a high or low value using C 
code instructions, which corresponds to +5 V or 0 V at the pin. The pin is connected to external 
interface electronics and then to the device being switched on and off. The sequence of events is 
shown in this figure. 


Program sets pin 
high/low (1/0) 

1 

Board pin 
set to +5V/0V 

1 

Interface 
electronics use 
signal voltages and 
power supply to 
switch motor 
on/off 


digitalWrite(4,HIGH); 
digitalWrite(4,LOW); 

+5V 




To determine the state of switches and other sensors, the Arduino is able to read the voltage 
value applied to its pins as a binary number. The interface circuitry translates the sensor signal 
into a 0 or +5 V signal applied to the digital I/O pin. Through a program command, the Ardiomp 
interrogates the state of the pin. If the pin is at 0 V, the program will read it as a 0 or LOW. If it 
is at +5 V, the program will read it as a 1 or HIGH. If more than +5 V is applied, you may blow 
out your board, so be careful. The sequence of events to read a pin is shown in this figure. 
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Program reads 
value of pins (1/0) 

t 

Board pins 
set to +5V/0V 

t 

Interface 

electronics change 
sensor signals into 
+5V/0V 


digitalRead(4) ; 


+5V 

—C ov 

I ED 


PIN 4 

o- 


+5 V 



Interacting with the world has two sides. First, the designer must create electronic interface 
circuits that allow motors and other devices to be controlled by a low (1-10 mA) current signal 
that switches between 0 and 5 V, and other circuits that convert sensor readings into a switched 0 
or 5 V signal. Second, the designer must write a program using the set of Arduino commands 
that set and read the I/O pins. Examples of both can be found in the Arduino resources section of 
the ME2011 web site. 


When reading inputs, pins must have either 0 or 5V applied. If a pin is left open or "floating", it will read random 
voltages and cause erratic results. This is why switches always have a 10K pull up resistor connected when 
interfacing to an Arduino pin. 


Note: The reason to avoid using pins 0 and 1 is because those pins are used for the serial communications between 
the Arduino and the host computer. 


The Arduino also has six analog input pins for reading continuous voltages in the range of 0 to 5 
V from sensors such as potentiometers. 

6 Programming Concepts 

This chapter covers some basic concepts of computer programming, going under the assumption 
that the reader is a complete novice. 

A computer program is a sequence of step-by-step instructions for the computer to follow. The 
computer will do exactly what you tell it to do, no more no less. The computer only knows 
what's in the program, not what you intended. Thus the origin of the phrase, "Garbage in, 
garbage out". 
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The set of valid instructions conies from the particular programming language used. There are 
many languages, including C, C++, Java, Ada, Lisp, Fortran, Basic, Pascal, Perl, and a thousand 
others. The Arduino uses a simplified variation of the C programming language. 

For any programming language, the instructions must be entered in a specific syntax in order for 
the computer to interpret them properly. Typically, the interpretation is a two step process. A 
compiler takes the language specific text you enter for the program and converts it into a 
machine readable form that is downloaded into the processor. When the program executes, the 
processor executes the machine code line by line. 

6.1 Basics of Programming Languages 

All sequential programming languages have four categories of instructions. First are operation 
commands that evaluate an expression, perform arithmetic, toggle states of I/O lines, and many 
other operations. Second are jump commands that cause the program to jump immediately to 
another part of the program that is tagged with a label. Jumps are one way to break out of the 
normal line-by-line processing mode. For example, if you want a program to repeat over and 
over without stopping, have the last line of the program be a jump command that takes the 
program back to its first line. Third are branch commands that evaluate a condition and jump if 
the condition is true. For example, you might want to jump only if a number is greater than zero. 
Or, you might want to jump only if the state of an i/o line is low. Fourth are loop commands that 
repeat a section of code a specified number of times. For example, with a loop you can have a 
light flash on and off exactly six times. 

Most programming languages contain a relatively small number of commands. The complexity 
of computers comes from combining and repeating the instructions several million times a 
second. 

Here's a generic program. 


1. Do this 

2. Do that 

3. Jump to instruction 6 

4. Do the other thing 

5. All done, sleep 

6. If switch closed, do that thing you do 

7. Jump to instruction 4 


The computer will execute this line by line. The art of programming is simply a matter of 
translating your intent into a sequence of instructions that match. 

Here is an example of a for loop command followed by a branch command that uses an IF 
statement 


for (i=0;i<6,i++) { 

instructions 

} 
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if (j > 4) goto label 
instructions 


The commands inside the loop will be repeated six times. Following this, if the value of the 
variable j is greater than 4, the program will skip to the instruction tagged with the specified 
label, and if not, the line following the if statement will be executed. 

In addition to the basic commands, languages have the ability to call functions which are 
independent sections of code that perform a specific task. Functions are a way of calling a 
section of code from a number of different places in the program and then returning from that 
section to the line that follows the calling line. Here's an example 


apples(); 
instructions 
apples(); 
more instructions 

void apples() { 

instructions 
j 


The function apples is everything between the set of braces that follows “apples()”. When the 
function completes, the program jumps back to the line following the line that called the 
function. 

6.2 Digital Numbers 

When working with a microcontroller that interacts with the real world, you have to dig a little 
below the surface to understand numbering systems and data sizes. 

A binary (base 2) variable has two states, off and on, or 0 and 1, or low and high. At their core, 
all computers work in binary since their internal transistors can only be off or on and nothing 
between. Numbers are built up from many digits of binary numbers, in much the same way that 
in the base 10 system we create numbers greater than 9 by using multiple digits. 

A bit is one binary digit that can take on values of either 0 or 1. A byte is a number comprised of 
8 bits, or 8 binary digits. By convention, the bits that make up a byte are labeled right to left with 
bit 0 being the rightmost or least significant bit as shown below 


b7 

b6 

b5 

b4 

b3 

b2 

bl 

bO 


Thus, in the binary number Oil, bits 0 and 1 are 1 while bit 2 is 0. In the binary number 
1000001, bits 0 and 7 are 1 and the rest are zero. 

Here are a few binary to decimal conversions for byte size numbers. 


Binary 

Decimal 

00000011 

3 

00000111 

7 
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11111111 


255 


In a computer, variables are used to store numbers. A bit variable can take on two values, 0 and 
1, and is typically used as a true/false flag in a program. A byte variable can take on integer 
values 0-255 decimal while a 16-bit word variable can take on integer values 0-65,535. Variables 
can be either signed (positive and negative values) or unsigned (positive only). 

7 Arduino Programming Language 

The Arduino runs a simplified version of the C programming language, with some extensions for 
accessing the hardware. In this guide, we will cover the subset of the programming language that 
is most useful to the novice Arduino designer. For more information on the Arduino language, 
see the Language Reference section of the Arduino web site, 
http://arduino.cc/en/Reference/HomePage . 

All Arduino instructions are one line. The board can hold a program hundreds of lines long and 
has space for about 1,000 two-byte variables. The Arduino executes programs at about 300,000 
source code lines per sec. 

7 .1 Creating a Program 

Programs are created in the Arduino development environment and then downloaded to the 
Arduino board. Code must be entered in the proper syntax which means using valid command 
names and a valid grammar for each code line. The compiler will catch and flag syntax errors 
before download. Sometimes the error message can be cryptic and you have to do a bit of 
hunting because the actual error occurred before what was flagged. 

Although your program may pass cleanly through the syntax checker, it still might not do what 
you wanted it to. Here is where you have to hone your skills at code debugging. The Arduino did 
what you told it to do rather than what you wanted it to do. The best way to catch these errors is 
to read the code line by line and be the computer. Having another person go through your code 
also helps. Skilled debugging takes practice. 

7.2 Program Formatting and Syntax 

Programs are entered line by line. Code is case sensitive which means "myvariable" is different 
than "MyVariable". 

Statements are any command. Statements are terminated with a semi-colon. A classic mistake is 
to forget the semi-colon so if your program does not compile, examine the error text and see if 
you forgot to enter a colon. 

Comments are any text that follows “//” on a line. For multi-line block comments, begin with 
“/*” and end with “*/” 


Constants are fixed numbers and can be entered as ordinary decimal numbers (integer only) or 
in hexadecimal (base 16) or in binary (base 2) as shown in the table below 


Decimal 


Hex 


Binary 


16 








100 


0x64 


B01100100 


Labels are used to reference locations in your program. They can be any combination of letters, 
numbers and underscore (_), but the first character must be a letter. When used to mark a 
location, follow the label with a colon. When referring to an address label in an instruction line, 
don't use the colon. Here's an example 


repeat: digitalWrite(2,HIGH) ; 
delay(1000) ; 
digitalWrite(2 , LOW); 
delay(1000) ; 
goto repeat; 

Use labels sparingly as they can actually make a program difficult to follow and challenging to 
debug. In fact, some C programmers will tell you to never use labels. 

Variables are allocated by declaring them in the program. Every variable must be declared. If a 
variable is declared outside the braces of a function, it can be seen everywhere in the program. If 
it is declared inside the braces of a function, the variable can only be seen within that function. 

Variables come in several flavors including byte (8-bit, unsigned, 0 to 255), word (16-bit, 
unsigned, 0 to 65,536), int (16-bit, signed, -32,768 to 32,767), and long (32-bit, 
signed, -2,147,483,648 to 2,147,483,647). Use byte variables unless you need negative numbers 
or numbers larger than 255, then use int variables. Using larger sizes than needed fills up 
precious memory space. 

Variable declarations generally appear at the top of the program 

byte i; 
word k; 
int length; 
int width; 


Variable names can be any combination of letters and numbers but must start with a letter. 
Names reserved for programming instructions cannot be used for variable names and will give 
you an error message 

Symbols are used to redefine how something is named and can be handy for making the code 
more readable. Symbols are defined with the "#define" command and lines defining symbols 
should go at the beginning of your program. Here's an example without symbols for the case 
where an LED is connected to pin 2. 

void setup () 

{ 

pinMode(2,OUTPUT); 

} 

void loop() 

{ 

digitalWrite(2,HIGH); // turn LED on 
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delay(1000); 

digitalWrite(2,LOW); // turn LED off 

delay(1000); 

} 

Here is the same using a symbol to define "LED" 

fdefine LED 2 // define the LED pin 

void setup () 

{ 

pinMode(LED,OUTPUT); 

} 

void loop () 

{ 

digitalWrite(LED,HIGH); 
delay(500); 

digitalWrite(LED,LOW); 
delay(500); 

} 

Note how the use of symbols reduces the need for comments. Symbols are extremely useful to 
define for devices connected to pins because if you have to change the pin that the device 
connects to, you only have to change the single symbol definition rather than going through the 
whole program looking for references to that pin. 

7.3 Program Structure 

All Arduino programs have two functions, setup() and loop(). The instructions you place in the 
startupO function are executed once when the program begins and are used to initialize. Use it to 
set directions of pins or to initialize variables. The instructions placed in loop are executed 
repeatedly and form the main tasks of the program. Therefore every program has this structure 

void setup() 

{ 

// commands to initialize go here 

} 

void loop() 

{ 

// commands to run your machine go here 

} 

The absolute, bare-minimum, do-nothing program that you can compile and run is 

void setup () {} void loop() {} 

The program performs no function, but is useful for clearing out any old program. Note that the 
compiler does not care about line returns, which is why this program works if typed all on one 
line. 
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7.4 Math 

The Arduino can do standard mathematical operations. While floating point (e.g. 23.2) numbers 
are allowed if declared as floats, operations on floats are very slow so integer variables and 
integer math is recommended. If you have byte variables, no number, nor the result of any math 
operation can fall outside the range of 0 to 255. You can divide numbers, but the result will be 
truncated (not rounded) to the nearest integer. Thus in integer arithmetic, 17/3 = 5, and not 5.666 
and not 6. Math operations are performed strictly in a left-to-right order. You can add parenthesis 
to group operations. 

The table below shows some of the valid math operators. Full details of their use can be found in 
the Arduino Language Reference. 


Symbol 

Description 

+ 

addition 

- 

subtraction 

* 

multiplication 

/ 

division 

o 

o 

modulus (division remainder) 

« 

left bit shift 

» 

right bit shift 

& 

bitwise AND 

1 

bitwise OR 


8 The Simple Commands 

This section covers the small set of commands you need to make the Arduino do something 
useful. These commands appear in order of priority. You can make a great machine using only 
digital read, digital write and delay commands. Learning all the commands here will take you to 
the next level. 

If you need more, consult the Arduino language reference page at h 
http://arduino.cc/en/Reference/HomePage . 


pinMode 

This command, which goes in the setup() function, is used to set the direction of a digital I/O pin. 
Set the pin to OUTPUT if the pin is driving and LED, motor or other device. Set the pin to 
INPUT if the pin is reading a switch or other sensor. On power up or reset, all pins default to 
inputs. This example sets pin 2 to an output and pin 3 to an input. 

void setup() 

{ 

pinMode(2,OUTPUT); 
pinMode(3,INPUT); 

} 

void loop() {} 

Serial.print 
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The Serial.print command lets you see what's going on inside the Arduino from your computer. 
For example, you can see the result of a math operation to determine if you are getting the right 
number. Or, you can see the state of a digital input pin to see if the Arduino is a sensor or switch 
properly. When your interface circuits or program does not seem to be working, use the 
Serial.print command to shed a little light on the situation. For this command to show anything, 
you need to have the Arduino connected to the host computer with the USB cable. 

For the command to work, the command Serial.begin(9600) must be placed in the setup() 
function. After the program is uploaded, you must open the Serial Monitor window to see the 
response. 

There are two forms of the print command. Serial.print() prints on the same line while 
Serial.println() starts the print on a new line. 

Here is a brief program to check if your board is alive and connected to the PC 

void setup () 

{ 

Serial.begin ( 9600); 

Serial.println("Hello World"); 

} 

void loop () {} 

Here is a program that loops in place, displaying the value of an I/O pin. This is useful for 
checking the state of sensors or switches and to see if the Arduino is reading the sensor properly. 
Try it out on your Arduino. After uploading the program, use a jumper wire to alternately 
connect pin 2 to +5V and to Gnd. 

void setup () 

{ 

Serial.begin ( 9600); 

} 

void loop () 

{ 

Serial.printIn(digitalRead(2)); 
delay(100); 

} 

If you wanted to see the states of pins 2 and 3 at the same time, you can chain a few print 
commands, noting that the last command is a println to start a new line. 

void setup () 

{ 

Serial.begin(9600); 

} 

void loop () 

{ 

Serial.print("pin 2 = "); 

Serial.print(digitalRead (2 )); 

Serial.print ( " pin 3 = "); 

Serial.println(digitalRead(3) ) ; 
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delay(100) ; 


} 

You may have noticed when trying this out that if you leave one of the pins disconnected, its 
state follows the other. This is because a pin left floating has an undefined value and will wander 
from high to low. So, use two jumper wires when trying out this example. 

Here's one that checks the value of a variable after an addition. Because the calculation is done 
just once, all the code is in the setup() function. The Serial.flush() 

int i,j,k; 
void setup() 

{ 

Serial.begin(9600); 
i=21; 
j =2 0; 
k=i+j; 

Serial.flush(); 

Serial.print(k); 

} 

void loop () {} 


digitalWrite 

This command sets an I/O pin high (+5V) or low (0V) and is the workhorse for commanding the 
outside world of lights, motors, and anything else interfaced to your board. Use the pinMode() 
command in the setup() function to set the pin to an output. 

digitalWrite(2,HIGH); // sets pin 2 to +5 volts 
digitalWrite(2,LOW); // sets pin 2 to zero volts 


delay 

Delay pauses the program for a specified number of milliseconds. Since most interactions with 
the world involve timing, this is an essential instruction. The delay can be for 0 to 4,294,967,295 
msec. This code snippet turn on pin 2 for 1 second. 

digitalWrite(2,HIGH); // pin 2 high (LED on) 

delay(lOOO); // wait 500 ms 

digitalWrite(2 , LOW); // pin 2 low (LED off) 


if 

This is the basic conditional branch instruction that allows your program to do two different 
things depending on whether a specified condition is true or false. 

Here is one way to have your program wait in place until a switch is closed. Connect a switch to 
pin 3 as shown in Section 3. Upload this program then try closing the switch 

void setup () 
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{ 

Serial.begin (9600); 

} 

void loop() 

{ 

if (digitalRead(3) == LOW) { 

Serial.println("Somebody closed the switch!"); 

} 

} 

The if line reads the state of pin 3. If it is high, which it will be for this circuit when the switch is 
open, the code jumps over the Serial.println command and will repeat the loop. When you close 
the switch, 0V is applied to pin 3 and its state is now LOW. This means the if condition is true so 
this time around the code between the braces is executed and the message is printed 
The syntax for the if statement is 

if ( condition) { 

//commands 

} 

If the condition is true, the program will execute the commands between the braces. If the 
condition is not true, the program will skip to the statement following the braces. 

The condition compares one thing to another. In the example above, the state of pin 1 was 
compared to LOW with ==, the equality condition. Other conditional operators are != (not equal 
to), > (greater than), < (less than), >= (greater than or equal to), and <= (less than or equal to). 

You can have the program branch depending on the value of a variable. For example, this 
program will print the value of i only when it is less than 30. 

int i; 

void setup () 

{ 

Serial.begin ( 9600); 
i=0; 

} 

void loop () 

{ 

i-i+1; 
if (i< 3 0) { 

Serial.println(i) ; 

} 

} 


for 
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The for statement is used to create program loops. Loops are useful when you want a chunk of 
code to be repeated a specified number of times. A variable is used to count the number of times 
the code is repeated. Here is an example that flashes an LED attached to pin 2 five times 

int i; 

void setup () 

{ 

pinMode(2,OUTPUT); 
for (i=0;i<5;i++) { 

digitalWrite(2,HIGH); 
delay(250); 
digitalWrite(2,LOW); 
delay(250); 

} 

} 

void loop() {} 

The variable i is the loop counter. The for() statement has three parts: the initialization, the check 
and the increment. Variable i is initialized to zero. The check is to see if i is less then 5. If so, the 
commands between the braces are executed. If not, those commands are skipped. After the 
check, i is incremented by 1 (the i++ command). While the for statement could read for 
(i=l;i==5;i++), it is convention to start the counter variable at zero and use less than for the 
condition check. 

You can have the loop counter increment by two or by three or by any increment you want. For 
example, try this code fragment. 

int i; 

void setup () 

{ 

Serial.begin ( 9600); 
for (i=0;i<15;i=i+3) { 

Serial.println (i); 

} 

} 

void loop () {} 

Loops can be nested within loops. This example will flash the LED 10 times because for each of 
the five outer loops counted by i, the program goes twice through the inner loop counted by j. 

int i,j; 
void setup () 

{ 

pinMode(2 , OUTPUT); 
for (i=0;i<5;i+#) { 

for(j=0;j<2;j++) { 

digitalWrite(2,HIGH); 
delay(250) ; 
digitalWrite(2,LOW); 
delay(2 50) ; 

} 

} 
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} 

void loop() {} 


while 

The while statement is another branch command that does continuous looping. If the condition 
following the while is true, the commands within the braces are executed continuously. Here is 
an example that continuously reads a switch on pin 3, and then when the switch is pressed, the 
condition is no longer true so the code escapes the while command and prints. 

void setup () 

{ 

Serial.begin ( 9600); 

while(digitalRead(3) == HIGH) { 

} 

Serial.println("Switch was pressed"); 

} 

void loop() {} 


goto 

The goto statement commands the computer to jump immediately to another part of the program 
marked by an address label. The goto should be used sparingly because it makes the program 
hard to follow, but is handy for breaking out of nested loops or other complex control structures. 
Here is an example 


void setup () 

{ 

Serial.begin ( 9600); 
while(true) { 

if (digitalRead(3) == LOW) { 
goto wrapup; 

} 

} 

wrapup: 

Serial.println("Switch was pressed"); 

} 

void loop() {} 

The while(true) statement runs continuously, checking the state of pin 3 each time. When pin 3 is 
low (pressed), the if condition is true and the goto statement executed, breaking out of the while 
loop. 

functions 

Functions are a powerful programming feature that are used when you want to set up an action 
that can be called from several places in the program. For example, let's say you wanted an LED 
connected to pin 2 to flash 3 times as an alert, but that you needed to execute the alert at three 
different places in the program. One solution would be to type in the flashing code at the three 
separate program locations. This uses up precious code space and also means that if you change 
the flash function, for example changing from 3 flashes to 4, you have to change the code in 
three places. A better solution is to write the flash function as a subroutine and to call it from the 
main body of the code. Here is an example 
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int i; 

void setup () 

{ 

pinMode(2 , OUTPUT); 

Serial.begin(9600); 

Serial.println("Welcome to my program"); 
delay(1000); 

flasher(); // call flasher function 

Serial.println("I hope you like flashing"); 
delay(1000); 

flasher(); // call flasher again 

Serial.println("Here it is one more time"); 

delay(1000); 

flasher() ; 

} 

void loop() { } 

void flasher () 

{ 

for(i=0;i<3;i++) { 

digitalWrite(2 , HIGH); 
delay(250); 
digitalWrite(2 , LOW); 
delay(250); 

} 

} 

Several things should be noted here. The function flasher() is defined outside the setup() and 
loop() functions. When the main program encounters a flasher(); command, the program 
immediately jumps to the function and starts executing the code there. When it reaches the end 
of the function, the program returns to execute the command that immediately follows the 
flasher(); command. It is this feature that allows you to call the subroutine from several different 
places in the code. Parameters can be passed to and returned from functions, but that feature is 
for the advanced programmer. 

This concludes the section on basic program commands. You can write some awesome programs 
using just what was described here. There is much more that the Arduino can do and you are 
urged to read through the complete Arduino Language Reference page on-line 

9 Coding Style 

Style refers to your own particular style for creating code and includes layout, conventions for 
using case, headers, and use of comments. All code must follow correct syntax, but there are 
many different styles you can use. Here are some suggestions: 

• Start every program with a comment header that has the program name and perhaps a brief 
description of what the program does. 

• Use indentation to line things up. Function name and braces are in column one, then use 
indents in multiples of 2 or 4 to mark code chunks, things inside loops and so on. 
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Mark major sections or functions with a comment header line or two 


• Have just the right number of comments, not too few and not too many. Assume the reader 
knows the programming language so have the comment be instructive. Here is an example of 
an instructive comment 

digitalWrite(4,HIGH) // turn on motor 

and here is a useless comment 

digitalWrite(4,HIGH) // set pin 4 HIGH 

You need not comment every line. In fact, commenting every line is generally bad practice. 

• Add the comments when you create the code. If you tell yourself, "Oh, I'll add the comments 
when the code is finished", you will never do it. 

10 Common Coding Errors 

• Forgetting the semi-colon at the end of a statement 

• Misspelling a command 

• Omitting opening or closing braces 


Please send comments, suggestions and typo alerts about this guide to wkdurfee@umn.edu 


11 Appendix 

On the following page is a summary of basic Arduino commands, with examples. 
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Arduino Programming Basics 


Command 

Description 

pinMode (n, INPUT) 

Set pin n to act as an input. One-time command at top of program. 

pinMode (n, OUTPUT) 

Set pin n to act as an output 

digitalWrite (n, HIGH) 

Set pin n to 5V 

digitalWrite (n, LOW) 

Set pin n to 0V 

delay(x ) 

Pause program for x millisec, x = 0 to 65,535 

tone ( n,f , d) 

Play tone of frequency f Hz for d millisec on speaker attached to pin n 

for () 

Loop. Example: for (i=0;i<3;i++){} Do the instructions enclosed by {} three times 

if ( expr) {} 

Conditional branch. If expr true, do instructions enclosed by {} 

while (expr) { } 

While expr is true, repeat instructions in {} indefinitely 


For more commands see the ME2011 “Arduino Microcontroller Guide” and the Language Reference 
section of the arduino web site. 

Instructions in the setup() function are executed once. Those in the loop() function are executed 
indefinitely. 


Examples 

1. Turn on LED connected to Pin 2 for 1 s. 

void setup () { 

pinMode(2,OUTPUT); 
digitalWrite(2,HIGH); 
delay(1000) ; 
digitalWrite(2,LOW); 

} 

void loop() 

{ ) 

2. Flash LED connected to Pin 2 at 1 Hz forever. 

void setup () { 

pinMode(2,OUTPUT); 

} 

void loop() { 

digitalWrite(2,HIGH); 
delay(500); 
digitalWrite(2,LOW); 
delay(500); 

} 

3. Turn on motor connected to Pin 4 for 1 s. 

void setup () { 

pinMode(4,OUTPUT); 
digitalWrite(4,HIGH); 
delay(1000) ; 
digitalWrite(4,LOW); 

} 

void loop() 

{ ) 


4. Play 440 hz tone for one second on speaker 
connected to pin 5. Delay is needed because 
the program does not wait for the tone() 
command to finish but rather immediately goes 
to the command following tone(). 

void setup() { 

pinMode(5,OUTPUT); 
tone(5,440,1000) ; 
delay(1100); 

} 

void loop() 

{ ) 

5. LED is on Pin 2 and switch is on Pin 6. Turns 
on the LED for one sec when switch is pressed. 

void setup() { 

pinMode(2,OUTPUT); 

pinMode(6,INPUT); 

while (digitalRead(6) == HIGH) 

r 

digitalWrite(2,HIGH) ; 
delay(1000); 
digitalWrite(2 , LOW); 

} 

void loop() 

{} 
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